Skip to main content

CollectorsCloud Collectors Administration Guide

Configure the AWS SQS Cloud Collector

Set up the AWS SQS Cloud Collector to continuously ingest events from SQS queue.

  1. Before you configure the AWS SQS Cloud Collector, complete the Prerequisites to Configure AWS SQS Cloud Collector .

  2. Log in to the Exabeam Security Operations Platform with your registered credentials as an administrator.

  3. Navigate to Collectors > Cloud Collectors.

  4. Click New Collector.

    Collectors_page_2_AWS_SQS.png
  5. Click AWS SQS.

  6. Enter the following information for the cloud collector:

    AWS_SQS_collector_2.png
    • Name – Specify a name for the Cloud Collector instance.

    • Account – Select the AWS account you want to use with this Cloud Collector.

      If you have not yet created an AWS account, in the Account list, select Create Account. For instructions, see Add Accounts for AWS Cloud Collectors.

    • SQS-URL – Enter the SQS URL that you obtained while completing the Prerequisites to Configure AWS SQS Cloud Collector .

    • SQS-Region – Select the SQS region. For example, us-east-1.

    • Event Processing – Select the format of the event type in which you want the AWS SQS collector to collect data or logs.

      By default, the cloud collector processes Events per Line, however you can change the file processing to process events embedded in a JSON Array. If you choose JSON Array, you can optionally specify the JSON Path To Array (Period Delimited).

      For example, k3.k3_2 is the JSON path to the embedded JSON array below:

      {
          "k1": "v1",
          "k2": [
              "v2_1",
              "v2_2"
          ],
          "k3": {
              "k3_1": "v3_1",
              "k3_2": [
                  {
                      "obj1Key": "obj1Val"
                  },
                  {
                      "obj2Key": "obj2Val"
                  }
              ]
          }
      }

      If you do not specify a path for the JSON Array, the cloud collector assumes that the events are the array’s elements.

      [
          {
              "obj1Key": "obj1Val"
          },
          {
              "obj2Key": "obj2Val"
          }
      ]
  7. (Optional) SITE – Select an existing site or to create a new site with a unique ID, click manage your sites. Adding a site name helps you to ensure efficient management of environments with overlapping IP addresses.

    By entering a site name, you associate the logs with a specific independent site. A sitename metadata field is automatically added to all the events that are going to be ingested via this collector. For more information about Site Management, see Define a Unique Site Name.

  8. (Optional) TIMEZONE – Select a time zone applicable to you for accurate detections and event monitoring.

    By entering a time zone, you override the default log time zone. A timezone metadata field is automatically added to all events ingested through this collector.

    Timezone_sitename_site_management_1.png
  9. To confirm that the Exabeam Security Operations Platform communicates with the service, click Test Connection

  10. Click Install.

    AWS_S3_2.png

    A confirmation message informs you that the new Cloud Collector is created.